Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / MT-1206.ZIP;1 / INSTALL.EXE / MT-USER.DOC < prev next >

Wrap

Text File | 1992-09-12 | 72.1 KB | 1,653 lines

,--------------------------------------, | | | | | | | | | |MuziTrak | | | |System | | | | | | | | | | | | | | | |Copyright | | | |(c)1992 | | | |Blam | | | |Entertainment | Version| | |Group | 1.204| `--------------------------------------' _______ ____|__ | (R) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Copyright (c)1992 Blam Entertainment Group. All Rights Reserved. MuziTrak System Documentation Page i Table of Contents I: Warranty and License Terms and Conditions..... 1 II: Important Notices............................. 3 1. AUTOEXEC.BAT............................... 3 2. CONFIG.SYS................................. 3 III: System Requirements........................... 3 IV: Concept....................................... 4 V: General....................................... 4 VI: About the Mode................................ 6 VII: A Note About Registration..................... 6 VIII: Program Limitation............................ 7 IX: Upgrading to New Versions..................... 7 X: Applying Updates.............................. 8 XI: Automatic Registration Transferal............. 9 XII: Dos Command Line.............................. 9 XIII: Program Installation.......................... 9 XIV: Keyboard Control..............................11 XV: Main Menu.....................................12 1. Edit Menu..................................12 2. Report Menu................................12 3. Song Search................................12 4. Utility Menu...............................13 5. Configuration Menu.........................13 6. Quit Program...............................13 XVI: Edit Menu / Match Menu........................13 1. Find a Record..............................13 2. Add a Record...............................14 3. Match Report...............................14 4. View Record................................14 5. Edit record................................14 6. Record Print...............................15 7. Next Record................................16 8. Previous Record............................16 9. Quit Menu..................................16 MuziTrak System Documentation Page ii XVII: Report Menu...................................16 1. Grouping Menu..............................17 a. Artist..................................17 b. Category................................18 c. Release Year............................18 d. Audio Label.............................18 e. Catalog Number..........................18 f. Library.................................18 g. Quit Menu...............................18 2. The Reports................................18 a. Prefix..................................19 b. System Mode.............................19 c. Category................................19 d. Grouping................................19 e. Character...............................19 f. Format..................................20 g. Extension...............................20 3. Report Data................................20 a. Catalog Number..........................20 b. Artist..................................20 c. Title...................................20 d. AAD-ADD-DAD-DDD.........................20 e. DS-D3-DV-DG.............................21 f. File....................................21 g. CI......................................21 h. Audio Run...............................21 i. Year....................................21 j. Category................................21 k. Label...................................21 XVIII: Utility Menu..................................21 1. File Sort..................................21 2. Archive Data...............................22 3. Reindex Data...............................22 4. Program Information........................23 5. Dos Shell..................................23 6. Quit Menu..................................23 XIX: Configuration Menu............................23 1. Printer Menu...............................23 2. Report Format Menu.........................24 3. Archive Pick Menu..........................24 4. Extend CHR On/Off..........................25 5. Codes to On/Off............................25 6. Time Calculate On/Off......................25 7. Quit Menu..................................25 XX: Sample Screens................................25 1. Screen One.................................26 2. Screen Two.................................26 MuziTrak System Documentation Page iii XXI: Edit Disc Legend..............................27 A1. Format Select.............................27 B1. Special Recording Format..................27 C1. Q-Sound Select............................28 D1. Dolby Surround Select.....................28 E1. Artist....................................28 F1. Title.....................................28 G1. Label.....................................28 H1. Distributor...............................28 I1. Recording Format..........................29 J1. Special Format Indicator..................29 K1. Catalog Number............................29 L1. Category..................................29 M1. Special...................................29 N1. Library...................................30 O1. Release Year..............................30 P1. Tracks....................................30 Q1. Audio Run.................................30 R1. Video Run.................................30 S1. Track Titles..............................31 T1. Track Run Times...........................31 XXII: Association of Shareware Professionals........31 XXIII: Legal Tidbits.................................32 MuziTrak System Documentation Page 1 I: WARRANTY AND LICENSE TERMS AND CONDITIONS Please review the following terms and conditions carefully. By using this software, you indicate your acceptance of such terms and conditions and agree to be bound by them. This is a legal agreement between you, the end user, and Blam Entertainment Group. By using this software, you are agreeing to be bound by the terms and conditions of this agreement. If you do not agree to the terms and conditions of this agreement, you must destroy all copies of this program and its associated documentation, whether in printed or computer readable form. This software and all associated documentation are the copyrighted property of Blaine R. Young and Blam Entertainment Group. All references to Blam Entertainment Group within this document and its associated software refer to Blam Entertainment Group and all its representatives, including but not limited to Blaine R. Young. Bulletin Board Systems, diskette duplication companies, shareware vendors and the agents of each where this software may be found are not in any way affiliated with Blam Entertainment Group. They serve as distribution points only. Blam Entertainment Group hereby disclaims all warranties relating to this software, whether expressed or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. Blam Entertainment Group shall not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data, loss of business profits, business interruption or any other reason, even if Blam Entertainment Group has been advised of the possibility of such damages. In no event shall Blam Entertainment Group's liability for any damages ever exceed the price paid to register the use of this software, regardless of the form of the claim. Should this software prove to be defective, the user assumes the responsibility of paying the entire cost of all necessary servicing, repair, or correction of any incidental or consequential damages. Blam Entertainment Group does not warrant that the functions contained in this program will meet your requirements or that the operation of this software will be uninterrupted or error free. You also assume the responsibility for the selection of this software to achieve your intended results, and for the installation, use and results obtained from this software. MuziTrak System Documentation Page 2 You are granted a limited non-exclusive license to use, copy and distribute this software under the following conditions: (a) This software must be distributed free of charge, except to defray expenses incurred during duplication. Connection or subscription fees to access bulletin board systems are not duplication costs. (b) This software must be unmodified in any way, with all files intact. You may only distribute the files as shipped to you on the distribution diskette or within the archive file. If any provision of this agreement is found void, invalid or unenforceable, it will not affect the validity of the balance of this agreement, which shall remain valid and enforceable according to its terms and conditions. This license is effective until terminated. You may terminate it at any time by destroying this software together with all copies of the documentation whether in computer readable or printed form. You may not use, copy, rent, lease, sell, transfer, modify, decompile, disassemble or otherwise reverse engineer this software or its associated documentation except as provided in this agreement. Any such unauthorized act shall result in immediate and automatic termination of this license. All rights not expressly granted here are reserved by Blam Entertainment Group including the right to update the program and/or documentation without formal notice of any kind. Should any troubles occur, support is available for any version of this software by telephone or mail. Please notify us of any errors in this software or its associated documentation at the address or phone number below. Blaine R. Young Blam Entertainment Group 916 Tanguay Court Kanata, ONT CANADA K2L 3X5 (613) 591-7777 MuziTrak System Documentation Page 3 II: IMPORTANT NOTICES In order for MuziTrak System to operate to it's full potential, your computers AUTOEXEC.BAT and CONFIG.SYS may require adjustment. Refer to your DOS documentation for instructions regarding modifying and/or creating your AUTOEXEC.BAT and CONFIG.SYS files. 1. AUTOEXEC.BAT Your AUTOEXEC.BAT file should contain the following line to allow the printed reports to be output correctly. PRINT /D:PRN PRINT.COM (or PRINT.EXE depending on DOS version) is a file supplied with DOS which runs resident and allows files to be printed while the computer is doing other things. DOS MUST be able to locate PRINT in order for MuziTrak System to use it. This file is usually located in the DOS subdirectory which should be located in the PATH= statement in the AUTOEXEC.BAT file. Consult your DOS manual on the full functions of PRINT and the uses of the PATH statement. 2. CONFIG.SYS MuziTrak can open and use up to 10 files at any given moment. With the numerous files which may be open prior to running MuziTrak System, the system will require more file handles than DOS provides by default. For this reason, the following line must be included in your CONFIG.SYS file. Files=20 If your CONFIG.SYS already includes a files command, make sure it's value is at least 20. MuziTrak System will not honour any file handles above 8 if the files are loaded into high memory. All file handles should be located in conventional memory. III: SYSTEM REQUIREMENTS MS/DOS Version 2.1 or Greater 512k Minimum Ram Monochrome Monitor Supported Color Monitor (CGA/EGA/VGA/MCGA/SVGA) Recommended Hard Drive Recommended 8mhz or faster System Clock Recommended MuziTrak System Documentation Page 4 IV: CONCEPT The MuziTrak System was written to keep track of an ever growing number of Compact Discs. In reality, it is a condensed version of DiscTrak System, also available from Blam Entertainment Group. This program, although usable by anyone, is tailored for radio stations and collectors. V: GENERAL MuziTrak System is a series of 16 program files, two installation files and numerous report and other files. Seven of these files are issued in the archive file "MT-120.ZIP" (the .ZIP extension may differ depending on the archive program used.) or on the distribution diskette, depending on where you acquired the program. The Installation program creates two program files, four documentation files and two windows related files. The MuziTrak program itself creates 5 remaining program files. These files consist of a Master Database and a Slave Database, manually related back to the Master, two indexes and one configuration file. This program is written and tested on a Intel 386DX running at 20mHz, a 286 operating at 10mHz, and has been tested on all PC based processors and speeds available. At the slower speeds, the data compression/decompression will take time, especially when working with records containing very large numbers of track titles. These waits are not intolerable but for this reason, the 8mhz clock speed is recommended. The requirement for a hard drive is not forced. MuziTrak will allow the use of a SINGLE floppy drive system. However, using MuziTrak System on floppy disks is slower and severely limits the ability to track large numbers of discs. With the vast amounts of data it is possible to track, the floppy will not be in your best interest. This program DOES NOT support the use of dual floppy disk drives. Color monitors are recommended. Actually, the better the monitor, the better this program looks. We have found that reading text on CGA screens is a pain. But if that's all you've got, we decided to let it go at that and not force you to go out and buy a $3000 monitor to run our program. Aren't we nice? MuziTrak System Documentation Page 5 Trust us when we talk about the RAM requirements. This program will use every byte it can get it's hands on and is very nasty if there isn't enough. Once loaded you shouldn't have any problems, however. This software is incompatible with EXPANDED Memory. It must be disabled before running MuziTrak System. For your convenience, we disable all memory between 640k and 1024k for use with all CLIPPER COMPILED APPLICATIONS automatically. This condition will be cleared on exiting the program. While in the DOS SHELL, this condition will still be in effect, however access to memory above the 640k barrier which may be used by other programs is not affected. MuziTrak System is not particular when it comes to upper or lower case. It doesn't care if you type everything in all caps, all little letters or a mix of the two. Be happy and enter the data as you wish. However, this is not a spelling program. If you spelled a title wrong, and then spell it right while trying to locate it, you're out of luck. Try to remember to spell things correctly, or at least spell them the same wrong way consistently. SPECIAL NOTES ABOUT MICROSOFT WINDOWS: MuziTrak System will run properly under Microsoft Windows 3.0 or higher, provided certain considerations are made. For your convenience, a default .PIF file and .ICO file have been included which will assist you. When invoking MuziTrak from windows, reference the .PIF file on the command line. The load file for MuziTrak, MT.EXE, does not like being inside the first 64k of memory inside windows. The .PIF file will call LOADFIX.COM, a DOS file, before loading. This will prevent troubles invoking the DOS Shell from inside MuziTrak and additional problems when exiting from Windows. MuziTrak System may not run well within it's own window in 386 Enhanced mode. It is possible for the screen to write incorrectly, leaving parts of the screen blank or possibly from previous screens. Remember the base memory requirements when modifying or creating the .PIF file. MuziTrak System Documentation Page 6 VI: ABOUT THE MODE MuziTrak will accurately track all of your Compact Discs. You can keep track of running time, record label, year of issue and most importantly, the titles and running times of the individual songs on the disc itself (up to 999 per entry). Also available are tags for CD+Graphics discs, the short lived CD-Video 5" gold Video Discs and the even shorter lived CD-3, as well as Q-Sound encoding and Dolby Surround. VII: A NOTE ABOUT REGISTRATION This software is written with the user supported shareware concept in mind. It is a copyrighted product, You are encouraged to copy the program and share it with others. If you find this program useful, and wish to continue using it beyond a reasonable evaluation period, registration is required. Registration of MuziTrak System will give you the following: 1) Unique serial number 2) Notifications of new versions 3) Free Upgrades (See NEW VERSIONS) 4) For an nominal fee to cover the cost of disks and postage a diskette with the latest version will be sent. 5) Automatic Upgrade Subscription is available. It is up to you and your conscience to register this software. Incredible amounts of time and money have been spend during the development and testing of this program as it now stands. All this to provide you with the fastest, smallest and most complete program possible. Please remember our efforts when you are entering untold numbers of entries into this program and thinking, about the void it fills. For information regarding fees for registration, upgrades and upgrade subscription service, see MT-ORDER.DOC. When sending this form, only the first page is required. Print it out and set it to the address on the top of the form. MuziTrak System Documentation Page 7 VIII: PROGRAM LIMITATION MuziTrak is not limited in the number of record it can store, except by the size of the drive you're using. However there is a limit to how many records the program can keep track of in the Program Information Screen and in remembering the last active record. This limit is 9,999,999 records. If you begin to approach this limit, (I hope you have a VERY large hard drive) let me know and I'll make allowances. IX: UPGRADING TO NEW VERSIONS Upgrades of MuziTrak System are available to everyone, free of charge. If you receive an upgrade from any Bulletin Board System (BBS), you will be billed for any long distance charges from your local phone company, provided you're calling long distance. You may be required to pay a registration fee to access a particular BBS. These charges are independent of the registration fee for MuziTrak System. Blam Entertainment Group will try to keep all the major diskette duplicators up to date on the current revision of MuziTrak System. Upgrades are also available directly from Blam Entertainment Group, but registration is mandatory. Registered users of DiscTrak or MuziTrak may obtain a current copy of the program on diskette by filling out the "MT-ORDER.DOC" distributed in this package. Upgrade charges are listed in that document. Blam Entertainment Group offers a subscription service for our registered users. For a small processing fee, you can automatically receive all new versions of MuziTrak System. Simply fill out "MT-ORDER.DOC" and mark the subscription area to apply. Mail the completed form to Blam Entertainment Group. Current fees are listed in that document. If you have a file called "MT.EXE" in the MuziTrak directory, please delete it or rename it. The "MT.EXE" file distributed with this version of MuziTrak is exclusive to this release. MuziTrak System Documentation Page 8 X: APPLYING UPDATES This program incorporates an automatic update routine. It will apply itself the first time you run the program. This version of MuziTrak incorporates updates from the following versions: 1.00, 1.10, 1.11. MuziTrak System will apply any updates necessary and activate the Automatic Registration Transfer if applicable upon the first execution of a new version. Previous versions of MuziTrak System will not be removed from your drive. Once the updates have been applied, however, the databases will no longer work with older versions of the program. Below is a sample version number for MuziTrak System. The version stated is not necessarily a valid version. This chart documents when updates are required, based on version number. Version 1.001 | ||\-- Bug Fix number --\ No updates are | |\--- Version number --/ required when | | changed | | | \---- Version number --\ Updates are \-------Series Number ---/ required when changed MuziTrak incorporates a conversion routine to bring over all Compact Disc data from a sister program called DiscTrak. If you are a user of DiscTrak System, MuziTrak can convert your database to this new program. To enable this feature, enter "MT DTCONV" and press <ENTER> at the DOS Command Line. Your ".DBF" files from DiscTrak System (all nine (9) of them) must be present for the conversion to work. No files will be deleted. In addition, if you're a registered user of DiscTrak and the "DT-xxx.EXE" file is present, your registration serial number will automatically be transferred to MuziTrak. MuziTrak System Documentation Page 9 XI: AUTOMATIC REGISTRATION TRANSFER MuziTrak System will read the serial number out of your previous version and install it in the new file. The previous version of the .EXE file must be present for the transfer to take place. The Automatic Registration Transfer process is keyed off the first three numbers in the version number. In the example above, the transfer key is 100. With this example in mind, if you are currently using version 1.00 and upgrade to the bug fix load 1.001, the transfer keys are the same for both loads. In this case, the Automatic Registration Transfer process will not run, and manual installation of the serial number into the bug fix load is required. As long as the key in the old version is different from the key on the new, the process will run correctly. XII: DOS COMMAND LINE There are no command line switches in MuziTrak except for the DiscTrak System Conversion routine explained in the previous section. XIII: PROGRAM INSTALLATION Since you're reading this document, you have already installed the program. But for the purposes of completeness, here you go. The install program can be run from any drive or directory by simply typing INSTALL. The command line is as displayed below: INSTALL [target drive/directory] ie: INSTALL C:\MUZITRAK The [target drive/directory] is optional. If specified, the files will be installed into the specified directory of the specified drive. If the source and target drives are the same, you are you may omit the drive letter. The directory does not need to exist as the install program will create it automatically. If no target is specified, the currently selected drive and directory will be used. THERE IS NOT ENOUGH ROOM TO INSTALL THIS SOFTWARE ONTO A 360k DISKETTE, SO DON'T TRY. MuziTrak System Documentation Page 10 The following files should be present: Files beginning with "*" are created by the installation program. All others were shipped on the diskette or included in the archive file. File Name: Purpose of File: ------------ ---------------------------------------------- *MT-120.EXE Main program file. *MT.EXE System Start Up File *MT.ICO Microsoft Windows 3.x Icon File *MT.PIF Microsoft Windows 3.x Program Information File *MT-NEW.DOC Revision history information. *MT-ORDER.DOC Registration order form. *MT-READ.ME Important program operation information. *MT-USER.DOC Complete system documentation. Includes warranty, registration and usage information. INSTALL.EXE Installation file which creates the program. PACKING.LST Listing of all supplied programs and files. FILE_ID.DIZ BBS File Description INSTALL.DOC Important installation information. SUBSCRPT.DOC Vendor/BBS Subscription order form. SYSOP.DOC Information for BBS Distribution. VENDOR.DOC Information for disk vendors, distributors, user groups, and more. Do not use any of the above files from any previous version of MuziTrak System. The .PIF and .ICO may be safely used with other versions of MuziTrak System. At the DOS prompt, enter "MT" and press <ENTER>. The program will load and the title screen will appear. If this is the first time you've used MuziTrak, the program will prompt you that the database files are missing and ask if you would like to create them. Answering "No" will exit the program. Create the files and you will next be presented with the Main Menu. MuziTrak System Documentation Page 11 XIV: KEYBOARD CONTROL There are several shortcuts when using MuziTrak System to move quickly around the screen. All options in all menus and all YES/NO questions are single key driven, using the first letter of the option. You may also use the cursor keys to move the highlight bar up and down, pressing <ENTER> on the desired option. On a color monitor, when editing or adding a record, the field you are working on is red with intense white letters. Other fields are white with red letters. If you have a monochrome monitor, the selected field is in inverse video from the rest of the screen. While editing or adding, the following keys are active. Right Arrow Move one character to right Left Arrow Move one character to left Ctrl Rt Arrow Skip one word to right Ctrl Lt Arrow Skip one word to left Up Arrow Move to previous field Down Arrow Move to next field Ctrl T Delete to end of word Ctrl U Restore data to field Ctrl Y Delete from cursor to end of field Home Beginning of field Ctrl Home Beginning of first field on page End End of data or end of field if no data Ctrl End Beginning of last field on page Page Down Next Page, changes saved Page Up For editing screens, this will step back one screen. In all other screens, the next page will be displayed. Delete Delete character at cursor Backspace Delete character to left of cursor ESC Next Page, No changes saved. Except in the track edit & view screens, where the program will exit from the current routine and changes on current screen will not be saved. If pressed while answering a question, the current condition of the question will be maintained. MuziTrak System Documentation Page 12 XV: MAIN MENU Everything you will do in MuziTrak will be initiated from the Main Menu. Across the bottom of the screen is a program line. This line will be visible the during the entire program. As for the options, we'll start at the top of the menu. 1. Edit Menu This brings up a new menu to allow for database manipulation. The options include editing, adding, viewing, printing, etc. Detailed explanations of the options are forthcoming. 2. Report Menu This brings up a menu for the system's printed reports. Reports are written directly to disk. The various options will be detailed later. 3. Song Search Enter the title of the song you wish to search for. This doesn't have to be the entire title, or even the first word. MuziTrak will search for any match possible anywhere in the title. If you are looking for "Don't Ask Me Why" by Eurythmics, for example, you could search on "ASK" and the system will find it. Once again, remember your spelling. Once the scan is complete, a menu will appear which looks almost identical to the Edit Menu explained later. The only change is one option, Match Report, which creates a report containing all matches. The records will be presented sorted by Catalog Number. The format for the display is the same as the VIEW option under the EDIT MENU. You can view one, two all or none of the matches, in any order you desire. Refer to the EDIT MENU section for an explanation of each option. After each selected operation, the menu will be returned. This is true except for the MATCH REPORT option which will return to the main menu, so be sure to use that option after viewing or printing any of the other matches. MuziTrak System Documentation Page 13 4. Utility Menu This brings up a menu for the systems utilities. Operations available from this menu include sorting the database and storing the .DBF files within either a Zip, LZH or ARJ archive. DOS Shell and Program information are also in this menu. Details to follow. 5. Configuration Menu This is a menu to set all of MuziTrak System's variables. Included are Extended Character switches, Archive Program options, Report format, Printer Setup and Printer Code switches. Details to follow. 6. Quit Program System exit. A maintenance routine will run before exiting. This maintenance will delete any records you've marked for deletion. This is basically the same as the Sort Files option, but no sorting takes place. MuziTrak will exit to DOS when finished. XVI: EDIT MENU / MATCH MENU The database is modified through this menu. Across the bottom of the screen, MuziTrak will display the Artist, Title and Catalog number of the currently selected record. The Edit Menu / Match Menu will remain active until QUIT MENU has been selected. 1. Find Record The system will search for the selected artist and will display the artist and first title on the selection line or tell you the artist doesn't exist as typed. If MuziTrak can't find an exact match, it will search the entire artist field for the closest match. If no match is located however, the displayed record will be the record active before the find option was selected. This option is not available in the Match Menu. MuziTrak System Documentation Page 14 2. Add a Record Adds a blank record to the existing database. Once the record is added, you will proceed directly into the Edit routine. Follow that section for full details. This option is not available in the Match Menu. Once the record has been added, the system will ask you if you wish to add another record. If you answer "Yes", the add routine is repeated. The default "No" will take you back to the main menu. 3. Match Report Available only from the Match menu, this option will print all the matches found during a Scan Records session. The format for this report will be the same as any report run from the Report Menu and will be grouped by Catalog Number. See the Report Menu section and Scan Records section for details. 4. Edit Record The sample screens and the legend that follows will help in the understanding of what MuziTrak is trying to say. They will help you from being confused. This option is not available in the Match Menu. This option is executed automatically when you are adding a record to the database. If you are a previous user of MuziTrak or DiscTrak systems, it is possible that some deletion could take place on SLAVE 1 when exiting the program. This is normal and is a result of new data storage routines which were incorporated in versions 1.10 and 1.20. This is normal. Trust me. This is like an elementary school quiz. Simply in the blanks. Follow the steps below, referencing the sample screens and their explanations, and try not to get too far behind. On the first screen, you are prompted with the choice to edit the disc information. The default answer is "NO". If you are adding a record, the question will be skipped, sending you straight to the questions. You are only asked four questions about the disc. Once they are answered, the next screen will pop up, looking much like the CD Sample Screen in the screen section. MuziTrak System Documentation Page 15 When first entering this screen, the area for song titles will remain blank until the number of tracks field has been entered and read. Once you're ready to enter the titles, the correct number of spaces will appear, in groups of 10. Once the first ten titles and their running times are filled in, the next group of 10 will be presented, until you reach the number of tracks entered in the tracks field. PAGE UP and PAGE DOWN work accordingly on this screen. Once all titles are entered, MuziTrak will calculate the running times of all the tracks and advise you of any discrepancies between the AUDIO RUN time and the Calculated Time. If the times do not match, you will be asked if you wish to replace the entered time with the calculated time. This routine can be disabled with a switch in the Configuration Menu, however it will run when adding a record, regardless of the switch setting. This routine is not available on discs marked with CDV, as these discs have two different run times. Remember that run times reported by the record companies on individual songs do not include the "dead" space between songs, usually 2-4 seconds. For this reason, your calcluated times may be off. 5. View Record Once you've found the record you want, this option will view that record. The top section of the screen will remain constant, displaying information regarding the specific record. See the sample screens under Edit for specifics. The lower section is paged. Sometimes several pages will follow, depending on the information for that record. If there are additional pages, the system will prompt with "More" in the upper left corner of the screen indicating to press any key to advance to the next page. If "More" does not appear, the last page is being displayed and any key press will take you back to the MAIN MENU. Pages are the actual names of the titles of each song and their associated running times located on each disc, group by 10. Please see the Edit Section and the associated sample screens for the exact information. Everything is said in simple english terms. MuziTrak System Documentation Page 16 6. Record Print This option prints the currently selected record on a single 8.5 x 11" sheet of paper. The data printed out is the exact same information displayed with the View option, but only on paper and without the pauses between screens. MuziTrak System tests for the presence of a parallel printer before printing the information. If it can't find one or it is off line, the program will write the file directly to the current drive and directory using the following format to determine the name of the file. C:\MUZITRAK\MT-xxxxx.TXT \----------/ \-/\---/ \-/ | | | \- Standard Extension | | \------ Seconds Elapsed Since Midnight | \---------- Standard Header \------------------ Sample Directory This name will be displayed on the screen while the printout is being written. 7. Next Record Jumps one record forward. 8. Previous Record Jumps one record backward. 9. Quit Menu Returns to MAIN MENU. XVII: REPORT MENU This facility will create ASCII reports in three possible formats. The default report is the SMALL report which is 132 characters across by 62 lines per page. Then next report is the LANDSCAPE report and is 156 characters across by 47 lines down, per page. The third report PORTRAIT and is also 156 characters across, but is 62 lines per page. Which report is written is specified by selecting the proper option in the CONFIGURATION MENU, explained later. MuziTrak System Documentation Page 17 If your printer supports a landscape font with 15 cpi printing, this is the basic premise LANDSCAPE report. You can also use an external program which will allow the document to be printed sideways on the page. The PORTRAIT report will format the report onto 8 1/2" paper, in 20cpi format. For the SMALL report, any printer capable of 15 cpi will print these reports just fine. All reports are written directly do disk, regardless of which report format you chose. Any printer codes you've programmed into the program inside the CONFIGURATION MENU will be inserted into the proper report. Each report setup string will get added to the beginning of the report, with the clear down string being added at the end. However, if you've selected the Codes to Off in the CONFIGURATION MENU, no codes will be included in any report. Once the report is written, you will be asked if you wish to print the report. If "Yes", MuziTrak calls up the DOS program PRINT which will print the report. If the printout is not desired at this time or you're going to use an external program to print, select NO and control will be returned to MAIN MENU. NOTE: PRINT automatically ejects a page from the printer when printing is complete. In addition, a form feed code is included in the report to allow easy removal of the report from tractor feed printers and to insure proper operation when using external programs to print. There may be a blank page after printing is completed. This is not a malfunction. There is a single menu to step through. When the menu is present, the current report format will be displayed below the menu box. 1. Grouping Menu Beyond this selection, the report writer will take over. Inside each grouping, the records will be listed alphabetically. a. Artist The records will be grouped by ARTIST and then by Year of Release. This is the default selection. MuziTrak System Documentation Page 18 b. Category Records will be grouped according to their Category. c. Release Year The reports will be grouped on the Year the title was released. d. Audio Label For those of you who really want this report, here it is. All records are reported by their releasing label. e. Numbered Catalog Not that anyone actually asked for reports grouped by the catalog number, but what the heck. This will report all records grouped on the catalog number field. f. Library This will group all records by the library classification. I have included this in the grouping option because the library field is strictly random. It can contain any character or number known to mankind as long as it only occupies one space and can be typed from the keyboard. g. Quit Menu Like in all other menus, this will return you to the MAIN MENU. 2. The Reports Now that you have selected what to report and how to report it, MuziTrak System runs off and writes the report. Each report has a unique filename, based by the report you are running. This filename will be displayed on the main menu while the report is being written. Follow the explanation below for the name. MuziTrak System Documentation Page 19 C:\MUZITRAK\MT-CRTEL.TXT \----------/\-/||||| \-/ | | ||||| \-- Standard Extension | | ||||\----- Report Format | | |||\------ Extend Characters/Codes | | ||\------- Report Grouping | | |\-------- Report Category | | \--------- System Mode | \----------- Standard Prefix \------------------ Sample Drive/Directory a. Prefix Simply the standard prefix. All reports will have the "MT-" prefix. b. System Mode All reports will have a "C" in this field. c. Category All Reports will have an "R" in this field unless the report is being generated from the Match Menu. R=Report all records S=Song Search d. Grouping This is derived by the grouping option you select. A=Artist C=Category Y=Year of Release N=Numbered Catalog R=Record Label L=Library e. Extend Character / Printer Codes Setting This is the setting of the Extended Character Set and the inclusion of printer codes into the reports as set in the Configuration Menu. E=Extended Characters (Above ASCII 127), No Codes F=Extended Characters including Printer Codes S=Standard Characters (Below ASCII 127), No Codes T=Standard Characters including Printer Codes MuziTrak System Documentation Page 20 f. Report Format This is the format of the Report L=Landscape Report - 156 Characters x 47 Lines P=Portrait Report - 156 Characters x 62 Lines S=Small Report - 132 Characters x 62 Lines g. Extension This will always be ".TXT" 3. Report Data The actual body of the reports consist of various types of information. All pages of the report will have headers giving page number, program version, time and date of the report. Data included in each report varies only by which report is being run. For example, the Small report does not contain all the data available in the Portrait or Landscape reports. These descriptions are for each of the fields included in all reports and the meanings of the data. All fields are included in all reports unless otherwise specified. a. Catalog Number This is pretty self explanatory. This is the catalog number of the Compact Disc. b. Artist Still more self explanatory stuff. c. Title More of the same. Overstating the obvious. d. AAD-ADD-DAD-DDD Recording sequence used on the disc. This field is not available in the Small report. AAD = Analog-Analog-Digital ADD = Analog-Digital-Digital DAD = Digital-Analog-Digital DDD = Digital-Digital-Digital MuziTrak System Documentation Page 21 e. DS-D3-DV-DG This one looks a little rough on the report as all the data tends to get lumped together. This field is not present in the Small report. D = Dolby Surround - Column 1 DV = CD-Video D3 = CD3 DG = CD+Graphics f. File Library classification will be documented here. This field is not included in the Small report. g. CI Chapter Index documents the total number of songs in the record. If this field is greater than 99, "**" will appear in this field. h. Audio Run The audio run time of the Compact Disc will be detailed here. This field is not present in the Small Report. i. Year The year of the audio program's release. j. Category Back to those fairly obscure fields which require pages and pages to describe. This field may be truncated in the Small report, depending on the data. k. Label The record label which released the program. This field may be truncated in the Small report, depending on the data. XVIII: UTILITY MENU The utility menu allows you to perform basic utility functions. From this menu, you may file sort, archive data with any of the supported archive programs, display program information and shell to DOS. 1. File Sort This will clear all databases of deleted records and sort them to allow for faster access and data processing. MuziTrak System Documentation Page 22 2. Archive Data This option will call up one of the supported compression archive programs as selected in the Configuration Menu, and create an archive file containing all the .DBF files for MuziTrak System as well as the .CFG file. This file will be named "MT-D-xxx.yyy" where xxx is the version of the MuziTrak and yyy is the default extension for the selected archive program. The archive programs are not included with MuziTrak System. You're responsible for their existence. The supported programs are called "PKZip.EXE", "LHA.EXE" and "ARJ.EXE". The files must be locatable through your computers PATH= statement in order for MuziTrak to find them. In addition, the programs must be called the default name. Several people rename PKZIP to things like "ZIP" and "Z". In order for MuziTrak to use these programs, the names must be as shipped by the author. LHA used to go by the name "LHARC". Versions of this compression program called "LHARC" will work with this program, provided you rename the file to "LHA.EXE". NOTE: Starting with version 1.10, the storage routines have been altered to take advantage of space. Additionally, version 1.20 includes true data compression. These changes will cause your archives to be larger than you may be used to. Don't worry. As we get smarter, these compression programs have less "space" to throw out. 3. Reindex Data From time to time, you may find it necessary to rebuild the system indexes. If you suspect index corruption, manifest by program crashes or incorrect displaying of data or any of a raft of symptoms, rebuilding the index files is the logical step. This can be accomplished one of two ways. First is to delete the indexes from DOS and allow MuziTrak to recreate them as it loads. The other option is to select this option from within the program. Both options will accomplish the same thing. MuziTrak System Documentation Page 23 4. Program Info This is the shareware screen. It will give you information on the program which will be necessary in the event you need support. It will total up the number of Compact Disc's the program is tracking and display that information. The ASP logo is also displayed here. Until you register, you will be reminded that the copy you are using is unregistered and will display a registration solicitation message. Once registered, this screen will display your registration number and will no longer display the solicitation. 5. DOS Shell This is our version of a DOS Shell. MuziTrak will clear itself from memory entirely, except for some minor memory to maintain the shell. You may run any application your memory will allow while in this shell. Your existing DOS Prompt will be amended to include instructions about how to return to MuziTrak. "EXIT" and <ENTER> will, of course, return you to the program, restoring your original prompt and resetting to the proper drive and directory in the process. The shell requires around 15k of memory. 6. Quit Menu Always pesky, that old Quit to Main Menu option raises it's ugly head in this menu too. XIX: CONFIGURATION MENU This menu allow you to setup MuziTrak Systems basic configurations for things like extended character set, default compression programs and printer codes for the reports. This menu will be visible until the Quit option is selected to ease the number of keystrokes when setting the options. 1. Printer Menu This option will bring up a menu which will give you a choice of six printer code fields to fill in. These fields will be tacked onto the beginning and end of each report that is run, depending on the Codes option. For example; the SMALL Setup will be added to the beginning of the SMALL report, the Reset SMALL codes will be added to the end of the report. MuziTrak System Documentation Page 24 Enter the exact string of commands you want to send to the printer. These codes are documented in your printer manual, or at least they should be. MuziTrak only has one minor hang up here. We don't like it when control characters are entered into a field. The characters in particular are anything below ASCII 32. To get around this, if your printer string requires any character from ASCII 1 to ASCII 31 enter ~xx~ instead, where xx is the decimal value of the character (01-31). The number in-between the tilde's (~) must be expressed as a two digit number, for example ~01~, ~02~, etc. Most printers today require an ESC before a series of codes so you will most likely have to use this procedure. Be sure to include the tilde (~) at the beginning and end. MuziTrak will see this and send the proper characters to the printer. Be sure not to add extra spaces to the command line which the printer does not require. Here is an example. This is the setup string for a Hewlett Packard DeskJet 500 for 16.67 cpi, Draft Quality and Landscape page orientation as you would enter it into the program. This setup string would be perfect for the LANDSCAPE report on this printer. ~27~(s16.67H~27~(s1Q~27~&l1O MuziTrak will replace the three occurrences of ~27~ with the proper ESC character before sending it to the printer. 2. Report Format Menu This menu is where the report format is chosen. The options are Small (132 x 62), Landscape (156 x 47) and Portrait (156 x 62). The highlight bar will display the default answer, or the currently set option. Quit Menu return to the Configuration Menu. 3. Archive Pick Menu This menu is where the archive programs are chosen. The supported options are PKWare's PKZip, Yoshizaki's LHA and Jung's ARJ. The highlight bar will display the default answer, or the currently set option. Quit Menu return to the Configuration Menu. MuziTrak System Documentation Page 25 4. Extend CHR On/Off This option was added to compensate for printers unable to print the extended character set, (characters over ASCII 127). The current state of the switch is stated on the item line. If the character set is currently enabled, the prompt will say "Extend CHR ON". If the set is disabled, the prompt will say "Extend CHR OFF". The answer will be stored and will be set accordingly each time you load MuziTrak. The default setting is "ON". 5. Codes to On/Off This option also is a toggle On/Off switch. Use it to tell MuziTrak not to send the preprogrammed printer codes to the reports. Default is on, send the codes. 6. Time Calculate On/Off This option is another On/Off switch. It is used to tell MuziTrak weither or not to calculate the total running times of songs included on Compact Discs. Default is on, calculate running times. NOTE: MuziTrak will calculate the times automatically upon adding a Compact Disc. This switch works only on subsiquent editing of the records. 7. Quit Menu As with most appearances of the Quit Menu prompt, this will take you back to the Main menu. XX: Sample Screens The actual screens differ slightly from those shown here. The field content of each is the same, however. MuziTrak System Documentation Page 26 1. SCREEN ONE =============================Compact Disc Catalog============================== Artist [....................................] Title [.......................................................] Label [............................] [............................] Distrib =============================================================================== | Rec Seq .... | Catalog [..............] | Tracks .... | | Format .... | Category [...................] | Audio Run .... | | | Special [...................] | Video Run .... | | | Library .... Release Year .... | | =============================================================================== Disc Record Editor Recording Format Sequence: 1) Analog-Analog-Digital, 2) Analog-Digital-Digital, 3) Digital-Analog-Digital, 4) Digital-Digital-Digital -A1- Special Recording Format: (C)D-3, (V)ideo 5", (G)raphic CD, (N)one -B1- Recorded in Q-Sound -C1- Recorded in Dolby Surround -D1- =MuziTrak System====Version 1.204===Copyright (c)1992 Blam Entertainment Group= 2: SCREEN TWO =============================Compact Disc Catalog============================== Artist [.................-E1-...............] Title [...........................-F1-........................] Label [...........-G1-.............] [.............-H1-...........] Distrib =============================================================================== | Rec Seq -I1- | Catalog [.....-K1-......] | Tracks -P1- | | Format -J1- | Category [.......-L1-........] | Audio Run -Q1- | | | Special [.......-M1-........] | Video Run -R1- | | | Library -N1- Release Year -O1- | | =============================================================================== Title Listings Run Time 1) [..........................-S1-...........................] [-T5-] 2) [..........................-S1-...........................] [-T5-] 3) [..........................-S1-...........................] [-T5-] 4) [..........................-S1-...........................] [-T5-] 5) [..........................-S1-...........................] [-T5-] 6) [..........................-S1-...........................] [-T5-] 7) [..........................-S1-...........................] [-T5-] 8) [..........................-S1-...........................] [-T5-] 9) [..........................-S1-...........................] [-T5-] 10) [..........................-S1-...........................] [-T5-] =MuziTrak System====Version 1.204===Copyright (c)1992 Blam Entertainment Group= MuziTrak System Documentation Page 27 XXI: Edit Disc Legend A1: Recording Format Sequence This information is still missing from some of today's releases. However, those records companies who care are to be congratulated. If it isn't listed anywhere on the disc, jewel box liner notes or on the shipping sleeve, you best guess is the most accurate answer. 1) Analog-Analog-Digital (AAD) - Default 2) Analog-Digital-Digital (ADD) 3) Digital-Analog-Digital (DAD) I have to laugh. I've only seen a few discs using this sequence. It's so rare, most record labels don't even include this write up in their liner notes. Let me ask you. Doesn't using an Analog recorder for subsequent mixing of the music defeat the purpose of recording it digitally? Maybe it's just me. 4) Digital-Digital-Digital (DDD) B1: Special Recording Format There are three possible choices in this field. 3" CD Those little discs that lived only a short while and will never be seen again, unless you're witness to a Coca-Cola promotion. Video 5" In the US, these discs were gold, but in Japan they are the standard silver. They are the normal 5 inch discs which have up to 5 minutes of full motion video on them as well as up to 20 minutes of CD compatible audio. Hard to find, but still available. A CDV-5 compatible LaserDisc player is required to play the video portion of these discs. Infinitely popular in England and Japan where they are called "Video Singles". In the US, they are used mostly for special applications. Graphics CD Sometimes the record company will tell you the disc has been encoded with CD+Graphics, and then again, sometimes they encode the disc with CD+Graphics and then forget to tell you. Maybe they forgot. I doubt it. MuziTrak System Documentation Page 28 Warner Bros., at one point, went off the beaten path to inform everyone about CD+Graphics. In a nut shell, CD+Graphics are a series of still photos or other non-moving picture that can be displayed on your television during playback of the CD. I have yet to see these in action, but they don't affect the sound of your CD in any way. Oh, you have to have a CD+Graphics or CD-I (Compact Disc Interactive) player to get at these little pictures. C1: Recorded in Q-Sound - Default "No" A recording process which will give spacious, 3-D sound on normal Stereo equipment. No special decoding into surround is necessary. Now isn't that special. D1: Recorded in Dolby Surround Dolby Surround has been around on Compact Discs for years and I've decided to start tracking for it. E1: Artist Pretty self explanatory. In addition, I put the name of the title here if it happens to be a soundtrack from a movie or TV Show. F1: Title Another easy one. What's the name of the album? G1: Label Look at the disc. There is usually fairly large lettering saying things like "Arista", "RCA", "Sire", "Capitol", etc. There's your answer. H1: Distributor This one's not so easy. If you read the fine print on the back of the jewel box, it may say something about "Distributed by". Then again, it may not. If you really care, you can try to figure it out. MuziTrak System Documentation Page 29 I1: Recording Format There are no right answers, just real english versions of the answer you gave. This isn't a test. The answer to the question -A1-. J1: Special Format Again this isn't a test. No wrong answers, unless you're just flat wrong. If you said it's a tape and it's really an album, you're gonna get the wrong answer. The answer to questions -B1-, -C1-, -D1-. K1: Catalog Number I usually put in the number on the edge of the jewel box in this field. For example, Annie Lennox's DIVA from RCA/BMG records is "06192-10624-2". The Slave database uses this field for control purposes. Just before you enter the actual song title information, explained later, the program will verify that you haven't duplicated the number anywhere else. L1: Category 20 characters to specify what kind of music is contained on the disc. M1: Special 20 more characters to say anything you want. I use it for things like Double Disc Set. MuziTrak System Documentation Page 30 N1: Library - Default="M" This is a random field. Anything put in this field will be converted to upper case, provided it's an alphabetic character. The only exception is noted below. D=Delete This will mark the active record and the associated slave records (if any) for deletion. **** WARNING! **** THIS WILL DELETE THE DISC from the database upon QUITTING the program, when you select "F" for a FILE SORT from the UTILITY MENU, or "A" for ARCHIVE from the UTILITY MENU. You can change this flag back to any other option by simply re-editing the record. Anything else in this field is allowed. O1: Release Year - Default=Current Year What year did the Compact Disc originally come out. Reissues of the Beach Boys albums on CD during 1990 and 1991 listed the dates as 1990 and 1991, however to get the catalog to list them properly, put in the date that the original albums were released. P1: Tracks Number of tracks on the Compact Disc. I don't track for specific discs with multi disc sets. Just lump everything together. Q1: Audio Run When you load up a Compact Disc, your player should give you a total run time for the disc. Enter it as MM.SS. R1: Video Run For use exclusively with CD-Video 5" discs. Enter it as M.SS. This field will not appear unless Video 5" was selected in question -B1-. MuziTrak System Documentation Page 31 S1: Title Listings There are a maximum of 999 entries for song titles. Once you fill up the 10 titles on page 1, (One song per line), the next page will flip up and allow you to enter songs 11 through 20. This will continue up through song 999. The number of songs you are allowed to enter is directly controlled by the number of tracks you entered in -P1-. There are 60 spaces maximum per line. When you edit the selected record, you will be given no selections until -P1- has been entered and read. When you're ready to enter the selection titles, the correct number of entries will appear. T1: Song Run Times There are also 999 of these fields to fill out. They are paged along with the titles and are subject to the same controls as the titles. XXII: ASSOCIATION OF SHAREWARE PROFESSIONALS This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve message via CompuServe Mail to ASP Ombudsman 70007,3536 MuziTrak System Documentation Page 32 XXIII: LEGAL TIDBITS "DeskJet 500" is a Trademark of Hewlett Packard Company "Dolby" and "Dolby Surround" are registered trademarks of Dolby Laboratories "PKZIP" is a registered Trademark and Patent of PKWare Inc. "ARJ" is a copyright of Robert K. Jung "LHA" is a copyright of Haruyasu Yoshizaki "Q-Sound" is a registered trademark of Q-Sound, INC. "Windows" and "Microsoft Windows" are registered trademarks of Microsoft Corporation "Annie Lennox: DIVA" - (c)1992 BMG Records (UK)